Skip to content

공부 목표: HTTP·외부 API와 실패 처리 ​

상태: 시작 전 · 작성일: 2026-09-09 · 목표 수준: Java·Spring 미들급 개발자의 독립적인 구현·검증·문제 해결

학습 목적 ​

외부 시스템의 지연, 응답 유실, 중복 요청을 전제로 API를 설계하고 결과가 불명확한 작업을 안전하게 복구한다.

학습 우선순위: 트랜잭션 기본 실습 뒤 진행한다. 결제·배송 등 외부 연동 업무가 있으면 우선순위를 높인다.

학습 환경 ​

  • Java / Spring Boot 버전: 미정
  • DB / 데이터 접근 기술: 미정
  • 실습 코드 위치: 미정

현재 프로젝트의 기술과 버전을 적은 뒤 시작한다. 확인하지 않은 동작은 가정으로 표시하고 실습으로 검증한다.

핵심 개념별 목표 ​

  • [ ] HTTP 의미와 계약: 메서드, 상태 코드, 헤더, 캐시의 기본 의미를 이해하고 요청·응답 형식과 오류 응답의 계약을 정의한다.
  • [ ] 타임아웃: 연결 대기와 응답 대기, 전체 작업 시간 제한을 구분한다. 클라이언트가 기다리기를 중단한 뒤에도 서버 작업이 완료될 수 있음을 이해한다.
  • [ ] 재시도: 일시적 오류와 영구적 오류를 구분하고 재시도 횟수·대기 시간·전체 시간 예산을 정한다. 여러 계층의 재시도가 호출 수를 증폭시키는 상황을 고려한다.
  • [ ] 멱등성: 같은 작업을 반복해도 효과가 중복되지 않는 성질이다. 멱등성 키의 범위·저장·만료, 같은 키에 다른 요청 내용이 오는 경우를 설계한다.
  • [ ] 부분 실패와 복구: 외부 결제 성공 후 내부 저장 실패처럼 시스템 간 결과가 어긋나는 상황을 모델링한다. 결과 조회, 상태 대조, 취소 등 후속 처리 기준을 정한다.
  • [ ] 장애 전파 제한: 외부 시스템이 느릴 때 우리 서비스의 스레드와 연결이 소진되지 않도록 동시 호출 수와 대기열을 제한한다. 반복 실패 시 호출을 일시 차단하는 회로 차단기의 목적을 이해한다.

실습 과제 ​

  1. 실제 결제 대신 로컬 가짜 결제 서버를 만들고, 성공·명시적 실패·응답 지연·처리 후 응답 유실을 각각 재현한다.
  2. 주문 API에 멱등성 키를 도입하고 순차 중복과 동시 중복 요청 모두에서 주문과 결제가 중복되지 않는지 검증한다.
  3. 결과 불명 상태를 별도로 저장하고 외부 거래 조회를 통해 최종 상태를 확정하는 복구 흐름을 만든다.
  4. 재시도 최대 횟수와 전체 제한 시간을 검증하고 중복 효과와 호출 폭증이 없는지 확인한다.

스스로 설명할 질문 ​

  • 결제 요청이 타임아웃이면 결제 실패로 확정할 수 있는가?
  • 같은 멱등성 키에 다른 금액이 들어오면 어떻게 응답해야 하는가?
  • 외부 결제는 성공했는데 우리 DB 저장이 실패하면 어떻게 복구하는가?

완료 기준 ​

  • [ ] 성공·실패·결과 불명의 상태와 전이 조건을 구분한다.
  • [ ] 순차 및 동시 중복 요청에서 중복 효과가 발생하지 않음을 검증한다.
  • [ ] 재시도 조건과 한도를 설명하고 복구 가능한 거래 식별자를 남긴다.
  • [ ] 실패 또는 경계 조건을 최소 하나 직접 재현하고 결과를 기록한다.
  • [ ] 선택한 방법과 대안의 비용을 비교하고 코드·테스트·로그 등 검증 근거를 연결한다.

개념 체크는 자신의 말로 설명하고 예제에서 확인했을 때 표시한다. 문서나 강의를 읽은 것만으로 완료 처리하지 않는다.

학습 기록과 확장 ​

  • 학습 노트: 아직 없음
  • 실습 결과: 아직 없음
  • 남은 질문: 아직 없음

메시지 큐, DB 변경과 발행할 이벤트를 함께 저장하는 아웃박스 패턴, 여러 단계의 보상 처리를 연결하는 사가 패턴으로 확장할 수 있다.

세부 주제가 커지면 이 폴더 안에 해당 주제의 폴더와 공부 목표.md를 만들고 여기에 상대 링크를 추가한다. 실제 학습 기록은 목표 문서와 별도 파일로 남긴다.

참고 자료 ​

  • 실습에 사용하는 Java·Spring·DB·HTTP 클라이언트의 버전을 먼저 기록하고 해당 버전의 공식 문서를 연결한다.

공식 문서는 설치된 버전에 맞춰 확인한다. DB 예시는 사용 DB가 다르면 해당 제품의 문서와 실험으로 대체한다.

전체 공부 목표로 돌아가기